home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / itrns211.zip / INSTALL.PC < prev    next >
Text File  |  1991-12-14  |  7KB  |  167 lines
  1. # Installation Instructions for the itrans package, version 2.0
  2. # Instructions For IBM-PC Compatible Systems.
  3. # $Header: e:/itrans/rcs/install.pc 1.2 91/12/14 16:14:28 avinash Exp $
  4.  
  5. 0: BE SURE TO UNPACK THIS PACKAGE SO THAT THE DIRECTORIES ARE
  6.    CREATED---NORMALLY THE unARCHIVERS JUST DUMP ALL FILES TO CURRENT
  7.    DIRECTORY.
  8.    From a ZIP archive, use the "-d" option.
  9.    From a ZOO archive, use the "e//" option.
  10.    Thus, use one of these commands:
  11.    E:ITRANS> unzip -d itrans.zip
  12.    or
  13.    E:ITRANS> zoo e// itrans.zoo
  14.  
  15. 1: If required, make and install all the programs.
  16.    Make may not be necessary since the executable is provided with
  17.    this package --- just install (copy) the executable to the BIN
  18.    directory.
  19.    To compile the program, change directory to "SRC", and 
  20.    edit the Makefile as required, run make first, then install the files.
  21.    Note that a makefile for the Turbo C 2.0 compiler is provided; some
  22.    hints have been provided in the makefile to use Microsoft C Compiler.
  23.  
  24.    E:\ITRANS\DOC> make
  25.    E:\ITRANS\DOC> make install
  26.  
  27.    Your compiler MUST be an ANSI-C compiler (to some extent at least:
  28.    new style function declarations, and function prototypes.)
  29.    If the make in the src directory fails (due to a non-ansi compiler),
  30.    you will need to re-edit the makefile (in some cases, even the sources)
  31.    to get it to compile.
  32.    There is a program provided, called "deansify", make that program
  33.    and use it to deansify the sources, and then try to compile them again.
  34.    To deansify a source file called xxx.c, use these commands:
  35.    
  36.    E:\ITRANS\DOC> make deansify.exe
  37.    E:\ITRANS\DOC> deansify.exe < xxx.c > tmpxx
  38.    E:\ITRANS\DOC> delete xxx.c
  39.    E:\ITRANS\DOC> rename tmpxx xxx.c
  40.    And so on, for all the sources. See the file "dodeans" to get the
  41.    list of files to be de-ansified (dodeans is a UNIX Shell Command File).
  42.  
  43. 2: Set up the environment variables required.
  44.    The environment variable ITRANSPATH must be set to the directory
  45.    where the files *.ifm, *.afm, *.tfm reside.
  46.    In my case, I have this line in my autoexec.bat:
  47.  
  48.    SET ITRANSPATH=E:\ITRANS\LIB
  49.  
  50.    See the file named "shenv"  in the lib directory, for all the
  51.    variables that need to be set.
  52.  
  53.    Edit the file bin\prips.bat, and set the directory path names there
  54.    to correct values.
  55.  
  56.    Add the itrans bin path to your PATH environment variable, so that the
  57.    commands "itrans" and "prips" can be found.
  58.  
  59. *** If you intend to use itrans for directly producing PostScript
  60.    output,  you are all set at this point.
  61.    Example usage:
  62.    Assuming your input file is named hindi.ips, the command to print
  63.    it would be:
  64.  
  65.    # cd to the doc directory
  66.    E:\ITRANS\DOC> itrans -P -i hindi.ips -o hindi.ps
  67.    E:\ITRANS\DOC> copy ..\lib\devnac.ps + ..\lib\itrans.pro + hindi.ps out.ps
  68.    # above creates a new file called out.ps, which can then be sent
  69.    # to a PostScript printer, or to a PostScript previewer.
  70.  
  71.    Instead of specifying all the three files to cat, you may use the
  72.    prips command---is present in the bin directory of the itrans
  73.    package. (It is a batch file---you will have to edit it to set the
  74.    correct directory path).
  75.    In that case, the commands are simplified to:
  76.  
  77.    E:\ITRANS\DOC> itrans -P -i hindi.ips -o hindi.ps
  78.    E:\ITRANS\DOC> prips hindi.ps
  79.  
  80.    The user manual document (idoc.itx) is written in TeX, but, a
  81.    PostScript file is also provided (idoc.ps).
  82.    Print out the PostScript file directly if you do not wish go thru
  83.    setting up all the files needed for a TeX setup.
  84.    (If present, the file is in the doc directory. Normally the .ps files
  85.     are NOT present, they are available in a separate package. You will
  86.     find the printer ready documentation package in the same place where you
  87.     found this package.)
  88.    The transliteration map for devanagari is again in TeX (devn.itx),
  89.    the PostScript file is (devn.ps).
  90.    The transliteration map for tamil is in TeX (tamil.itx),
  91.    the PostScript file is (tamil.ps).
  92.  
  93. *** To use the system with the TeX  language, you need to setup the files
  94.    and fonts so that TeX/LaTeX and dvips can locate them.
  95.    The following steps are necessary.
  96.  
  97. 3:
  98.    The files mentioned in this section all reside in the lib directory
  99.    (or, in the TFMDIR directory, if set differently in the Makefile),
  100.    of this itrans package.
  101.  
  102.    For devanagari support, add the following lines to the system file
  103.    psfonts.map:
  104.  
  105. ---stuff below this line---
  106. dnh     DevnacPlain <devnac.ps
  107. dnho     Devnagari-BoldOblique <devnac.ps "/DevnacPlain .167 SlantFont"
  108. dnhrc     Devnagari-BoldNarrow <devnac.ps "/DevnacPlain .82 ExtendFont"
  109. dnhre     Devnagari-BoldExpanded <devnac.ps "/DevnacPlain 1.2 ExtendFont"
  110. ---stuff above this line---
  111.    
  112.    psfonts.map will reside in some system area, you will have to search
  113.    around for it (TeX system areas).
  114.  
  115. 4: If you installed the file "devnac.ps" in some non-standard place
  116.    (with respect to your system's dvips installation),
  117.    add the pathname to the line starting with "H" in the file dvips.ini
  118.    (Create the file dvips.ini in the dvips system area,
  119.     see man page on dvips and its user manual, and the files readme.pc and 
  120.     config.ps in your dvips installation on the PC.)
  121.    If devnac.ps resides in E:\ITRANS\LIB\DEVNAC.PS, add this line to
  122.    dvips.ini:
  123.  
  124. ---stuff below this line---
  125. # provide all system path names first, then the path name for devnac.ps file
  126. H D:\EMTEX\MACROS;E:\ITRANS\LIB
  127. ---stuff above this line---
  128.  
  129. 5: Install the .tfm files in the standard place, or, if that is not
  130.    desirable, install it any directory, just append the directory pathname
  131.    to the environment variable TEXFONTS.
  132.  
  133.    For Tamil support, install the .mf files and the .pk files also, in
  134.    the standard places.
  135.  
  136.    Note that you must have the dvips version that handles PostScript fonts.
  137.    (Tomas Rokicki's version 5.41 or newer, see the FAQ in
  138.     comp.text.tex for more information.)
  139.  
  140. *** You are all set up now for both TeX/LaTeX and PostScript output
  141.    generation.
  142.  
  143. 6: Print out the document idoc.itx, it is the user's manual
  144.    for the "itrans" program.
  145.    idoc.itx contains transliterated hindi/tamil text, so it has to be
  146.    converted to a normal TeX file.
  147.    Run these commands:
  148.    E:\ITRANS\DOC> itrans -i idoc.itx -o idoc.tex
  149.    E:\ITRANS\DOC> latex idoc
  150.    E:\ITRANS\DOC> dvips idoc > out.ps
  151.    # above creates PostScript file called out.ps, which can be sent to
  152.    # a postscript printer or previewer.
  153.  
  154.    Do the same for the reference manuals, devn.itx and tamil.itx.
  155.  
  156. 7: Check out the sample data, print out the sample files provided.
  157.    Use the above examples given to print the files.
  158.    Files ending in .itx are TeX/LaTeX files, and files ending in .ips are
  159.    PostScript files meant for the dumb interface of itrans.
  160.    Follow the appropriate command sequences mentioned in this document to
  161.    print out the files.
  162.  
  163. 8: If you need to use the Frans Velthuis's Devnag font, you have to
  164.    get it by anonymous FTP---see details in the file dvng.itx.
  165.    Once you get it, install the TFM and PK files as would for any
  166.    other Metafont font on your system.
  167.